home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
drlistj.zip
/
DRLIST.DOC
< prev
next >
Wrap
Text File
|
1989-09-07
|
24KB
|
576 lines
DRLIST Version J
(c) Copyright Vernon D. Buerg 1986-89
Special BBS/CTTY Version
________________________
Sept 17, 1989
Table of Contents
-----------------
Description ...................... 1
Display format ................... 2
Status line ..................... 2
Command line .................... 3
Keys and commands ................ 4
Positioning to lines ............ 5
Cloning procedure ................ 6
DEBUG Information ............... 7
Screen attributes ............... 8
Searching for text................ 9
Filtering ........................ 10
Update history ................... 11
Special version remarks .......... 12
Restrictions ..................... 13
DRLIST Page 1
Command DRLIST
-------------
Purpose: To display the contents of an ASCII text file, line by line
with the aid of scrolling, positioning and filtering commands.
Format: DRLIST [d:][path]filename[.ext]
Remarks: An ASCII file of any size may be listed.
The "filename" is optional. If omitted, you are prompted to
to enter a filename. You may include drive, path, and wild
cards in the file name. The first file which matches the name
is displayed until an end-of-file character is encountered. Each
file which matches the "filename" may be displayed.
DRLIST was designed to display ASCII files. That is, files
which contain text and not binary or control codes. Text
characters usually range from a value of 32 to 127. To view
binary files (COM, EXE, etc), the D-key hex dump display option
is available.
Characters below 32 (a blank) are replaced with a funny
character to indicate that a non-displayable character has been
encountered. This character is an upside-down question mark.
Characters above 127 may be valid graphic characters, and may
be displayed if the '8' command is in effect. To insure that
characters above ASCII value 127 are not displayed, use the '7'
command.
The top line of the display gives the file name, current right
scroll offset, and the file's creation date and time. Optionally,
a ruler may be displayed on the top line by using the R key.
The file is displayed with one logical record on each
80-column display line. A logical record ends in a linefeed.
The maximum logical record may be 256 characters long. If the
record exceeds 80 characters, you may view the portion beyond
the 80 columns by using the scroll right command, or by using
the Wrap feature.
The Wrap command toggles ON or OFF the wrapping of lines
longer than 80 characters. With Wrap on, lines are displayed in
their entirety, 80 characters per display line. The scroll
-left and -right functions are disabled when Wrap is ON.
The file may be PRINTed as it it displayed. The P command
toggles the printer on or off. When first entered, the P
command causes the current screen to be printed. As new lines
are displayed, they too are printed. Printing may be stopped by
entering another P command. The PrtSc key may also be used, but
the title and prompt lines will be printed with the lines of the
file. Empty lines cause a line to be skipped on the printer. The
letter P is displayed in column 80 of the top line while printing.
DRLIST Page 2
Display format
--------------
The monitor display is defined in terms of lines and columns.
A typical monitor can display 25 lines of 80 columns each. DRLIST
attempts to use the number of lines and columns for the monitor
mode in use. For example, if the monitor is in 40 column mode,
DRLIST displays only 40 characters per line.
The top line of the display is called the Status line. The
bottom line is called the Command line. The remaining lines are
called the primary display window, and are usually lines 2
through 23.
Status line format
------------------
The Status line has the following format:
DRLIST lllll +sss mm/dd/yy hh:mm bKMPSW - filename
where,
'DRLIST' is the name of this program
'lllllll' is the line number of the first line in the
display window (usually on line 2)
'+sss' if displayed, this is the Scroll amount, in
multiples of 20, corresponding to the number
of columns that the display has been shifted
to the right to view records longer than 80
'mm/dd/yy' is the file's creation date
'hh:mm' is the file's creation time
'D' indicates that the hex Dump display option is in use
'b' indicates whether the 7-bit, 8-bit, or *-option is
in use
'K' indicates that the Keyboard flush option is in use
'M' indicates that tests for monitor retrace are not made
'P' indicates that Print is in use
'S' indicates that the C (file sharing) is in use
'W' indicates that the Wrap mode is in effect
DRLIST Page 3
Command line format
-------------------
The Command line has the following format:
command message ______ Keys: Num-keypad Q=next X=exit ?=Help
where,
'command' indicates the current process:
'Command' you are being asked to enter a command
enter the letter, or press the keys for
the action to perform
'Reading ' the file data is being read
'Filter ' the file data is being formatted for display
'Scanning' the Scan/Find text is being searched for
'Scan ' you are being asked to enter text to locate
'Find ' in the file, up to 31 characters may be entered
'# lines?' you are being asked to enter a 1 to 5 digit
number that is the amount of lines to skip
'Line #? ' you are being asked to enter a 1 to 5 digit
line number to which the display is to be
positioned
'message' may be one of:
'*** Text not found ***'
the Scan/Text was not found in the file
' *** Top of file ***'
the first line of the file is being displayed
' *** End-of-file ***'
the last line of the file is being displayed
DRLIST Page 4
Key functions and Commands
--------------------------
On the COMMAND line, enter a letter or control key:
Letter(s) Default Function
--------- ------- ------------------------
A find next occurance of 'text'
B skip to end of file (bottom)
C off toggles closing of (shared) files
D toggles hex dump display mode
E on set hi-bit on, Eight-bit mode
F Find 'text' regardless of case
H or ? list commands (HELP)